.TH lha_destroyapp 1 "23 April 2012" "TrueCL Commands"

.SH NAME
lha_destroyapp \- Remove an application from the Cluster

.SH SYNOPSES
.TS
l l.
lha_startnode	\fB-A|--application\fP \fIX\fP] [\fB--backup\fP] [\fB--timeout\fP \fIN\fP]
	[\fB--force\fP] [\fB--debug\fP|\fB--verbose\fP|\fB--quiet\fP|\fB--silent\fP]
	[\fB--lwidth\fP \fIN\fP]
.TE

.SH DESCRIPTION
The \fIlha_destroyapp(1)\fP command is used to remove application definitions 
from a cluster. To function by default the following conditions myst be
true:

.TP 4
*
The cluster must have all nodes contactable. The cluster does not need to be
running.

.TP
*
If the cluster is up and running the application must not be considered as
being running.
.RE

Please note that this utility does not destroy or remove storage in any way.
The storage is unaffected and can be used manually if necessary when the
application removal from TrueCL has been completed.

.SH ARGUMENTS
.TP 8
--application
The name of the application to remove. The application must obviously be the
name of an existing application that must currently not be running.

The application does not need to be defined to be runnable on the 
node of the cluster running this command; it can be run from any node.

.TP
--backup
This generates backup copies of the configuration database on all nodes
in the cluster before making any changes. Strongly recommended use for
production environments. 

.TP
--force
Normally the removal of the application will not take place if one or more
nodes are not contactable. If you really do wish to remove the node from the
cluster in such circumstances the action can be forced by using this flag.

.TP
--timeout
The length of time to wait for individual requests from various cluster daemons.
The default is 10 (seconds) if not specified on the command line.

.TP
--debug
Run the node addition in 'debug' mode - might produce significant levels 
of output to the standard output device, most of which is only useful for
developers.

.TP
--verbose
Verbose mode generates a sensible amount of output to standard output to 
show the progress of removal of the application from the cluster. 
This is the recommended flag if the administrator wishes to see 'progress' 
output.
.TP
--quiet
This will only produce errors and warnings on the standard output device.
.TP
--silent
Only produce output if fatal errors occur during attempted addition of the 
node to the cluster. 

.SH OUTPUT
In verbose mode the utility will show the addition of the node from to the 
cluster.

.SH EXIT CODES
If the application in question is successfully removed from the running cluster then 0 (success) will be returned. 
Any non-zero value indicates a failure to complete the requested application removal.

.SH FILES
No particular special files are used/generated by this utility.

.SH NOTES
No storage resources are released as part of this process - all storage allocated
to the application outside of TrueCL remain allocated.

.SH AUTHOR
The TrueCL software was written by Simon Edwards, (C) 2006-2012, working
for Advantsys Computer Services Ltd - www.advantsys.co.uk.

.SH SEE ALSO
.BR lha_buildapp(1),
.BR lha_stopapp(1).

.SH AVAILABILITY
This utility was specifically written under the GNU GPL license and as required
by such software comes with \fIno warranty or guarantee of any kind\fP. For
more information, please see the following page: truecl.advantsys.co.uk.

